<HTML><HEAD><TITLE>Manpage of raidz_test</TITLE>
</HEAD><BODY>
<H1>raidz_test</H1>
Section: User Commands (1)<BR>Updated: 2016<BR>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTION</A><DD>
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
<DT><A HREF="#lbAG">AUTHORS</A><DD>
</DL>
<HR>
<A HREF="../index.html">Return to Main Contents</A><HR>

<P>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

<B>raidz_test</B> - raidz implementation verification and bencmarking tool
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<P>

<B>raidz_test &lt;options&gt;</B>

<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<P>

This manual page documents briefly the <B>raidz_test</B> command.
<P>

Purpose of this tool is to run all supported raidz implementation and verify
results of all methods. Tool also contains a parameter sweep option where all
parameters affecting RAIDZ block are verified (like ashift size, data offset,
data size, etc...).
The tool also supports a benchmarking mode using -B option.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTION</H2>

<DL COMPACT>
<DT>
<B>-h</B><I></I>

<DT><DD>
<DD>Print a help summary.
<DT>
<B>-a</B><I> ashift (default: 9)</I>

<DT><DD>
<DD>Ashift value.
<DT>
<B>-o</B><I> zio_off_shift</I><B> (default: 0)</B>

<DT><DD>
<DD>Zio offset for raidz block. Offset value is 1 &lt;&lt; (zio_off_shift)
<DT>
<B>-d</B><I> raidz_data_disks</I><B> (default: 8)</B>

<DT><DD>
<DD>Number of raidz data disks to use. Additional disks for parity will be used
during testing.
<DT>
<B>-s</B><I> zio_size_shift</I><B> (default: 19)</B>

<DT><DD>
<DD>Size of data for raidz block. Size is 1 &lt;&lt; (zio_size_shift).
<DT>
<B>-S(weep)</B>

<DT><DD>
<DD>Sweep parameter space while verifying the raidz implementations. This option
will exhaust all most of valid values for -a -o -d -s options. Runtime using
this option will be long.
<DT>
<B>-t(imeout)</B>

<DT><DD>
<DD>Wall time for sweep test in seconds. The actual runtime could be longer.
<DT>
<B>-B(enchmark)</B>

<DT><DD>
<DD>This options starts the benchmark mode. All implementations are benchmarked
using increasing per disk data size. Results are given as throughput per disk,
measured in MiB/s.
<DT>
<B>-v(erbose)</B>

<DT><DD>
<DD>Increase verbosity.
<DT>
<B>-T(est the test)</B>

<DT><DD>
<DD>Debugging option. When this option is specified tool is supposed to fail
all tests. This is to check if tests would properly verify bit-exactness.
<DT>
<B>-D(ebug)</B>

<DT><DD>
<DD>Debugging option. Specify to attach gdb when SIGSEGV or SIGABRT are received.
<DT>
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>

<B>ztest (1)</B>

<A NAME="lbAG">&nbsp;</A>
<H2>AUTHORS</H2>

<DD>vdev_raidz, created for ZFS on Linux by Gvozden Nešković &lt;neskovic@gmail.com&gt;
<P>

</BODY>
</HTML>
